KCChooseCertificate

KCChooseCertificate
Header:	Keychain.h		Carbon status:	Under Evaluation

Displays a list of certificates that the user can choose.

OSStatus KCChooseCertificate (
    CFArrayRef items, 
    KCItemRef *certificate, 
    CFArrayRef policyOIDs, 
    KCVerifyStopOn stopOn
);

items: A Core Foundation array of certificate keychain item references.
certificate: On return, a pointer to the certificate keychain item. This is returned if the items array contains one keychain item. In this case, no user interface is displayed.
policyOIDs: A Core Foundation array of policy OIDs that determine the trust policy. To obtain a pointer to an array of policy OIDs for Macintosh file signing, call the function SecMacGetDefaultPolicyOIDs.
stopOn: One of the constants defined by the KCVerifyStopOn enumeration. For a description of these values, see “Verification Criteria Constants”.

function result: A result code. The result code userCanceledErr indicates that the user cancelled out from the user interface presented.

DISCUSSION

The KCChooseCertificate function displays a list of the certificates the user can chose if the items array contains at least two keychain items. Otherwise, it returns the single keychain item in the certificate parameter with no user interface.

VERSION NOTES

Available beginning with Keychain 2.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 2.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 2.0 and later.